<!DOCTYPE html>
<html class="no-js" lang="en">
<head>
  <meta charset="utf-8">
  <title>Zen 7.x-6.x Style Guide</title>

  <meta name="description" content="">
  <meta name="generator" content="kss-node">
  <meta name="viewport" content="width=device-width">

  <link rel="stylesheet" href="kss-assets/kss.css">
  <link rel="stylesheet" href="../css/styles.css">
<link rel="stylesheet" href="../css/style-guide/chroma-kss-styles.css">
<link rel="stylesheet" href="../css/style-guide/kss-only.css">

</head>
<body id="kss-node">

<div class="kss-sidebar kss-style">
  <header class="kss-header">
    <h1 class="kss-doc-title">Zen 7.x-6.x Style Guide</h1>
  </header>
  <nav class="kss-nav">
    <ul class="kss-nav__menu">
      <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="./">
          <span class="kss-nav__ref">0</span
          ><span class="kss-nav__name">Overview</span>
        </a>
      </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-sass.html">
          <span class="kss-nav__ref">1</span><span class="kss-nav__name">Colors and Sass</span>
        </a>
              </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-base.html">
          <span class="kss-nav__ref">2</span><span class="kss-nav__name">Defaults</span>
        </a>
              </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-layouts.html">
          <span class="kss-nav__ref">3</span><span class="kss-nav__name">Layouts</span>
        </a>
                  <ul class="kss-nav__menu-child">
                      <li class="kss-nav__menu-item">
              <a class="kss-nav__menu-link" href="section-layouts.html#kssref-layouts-layout-center">
                <span class="kss-nav__ref ">3.1</span
                ><span class="kss-nav__name">Layout Center</span>
              </a>
            </li>
                      <li class="kss-nav__menu-item">
              <a class="kss-nav__menu-link" href="section-layouts.html#kssref-layouts-layout-3col">
                <span class="kss-nav__ref ">3.2</span
                ><span class="kss-nav__name">Responsive 3-column grid</span>
              </a>
            </li>
                      <li class="kss-nav__menu-item">
              <a class="kss-nav__menu-link" href="section-layouts.html#kssref-layouts-layout-swap">
                <span class="kss-nav__ref ">3.3</span
                ><span class="kss-nav__name">Layout swap</span>
              </a>
            </li>
                    </ul>
              </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-components.html">
          <span class="kss-nav__ref">4</span><span class="kss-nav__name">Components</span>
        </a>
              </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-navigation.html">
          <span class="kss-nav__ref">5</span><span class="kss-nav__name">Navigation</span>
        </a>
              </li>
          <li class="kss-nav__menu-item">
        <a class="kss-nav__menu-link" href="section-forms.html">
          <span class="kss-nav__ref">6</span><span class="kss-nav__name">Forms</span>
        </a>
              </li>
        </ul>
  </nav>
</div>
<article role="main" class="kss-main">

  
          <div id="kssref-layouts" class="kss-section kss-section--depth-1">
      <div class="kss-style">
                <h1 class="kss-title kss-title--level-1">
          <a class="kss-title__permalink" href="#kssref-layouts">
            <span class="kss-title__ref">
              3
              <span class="kss-title__permalink-hash">
                layouts
              </span>
            </span>
            Layouts
          </a>
        </h1>

                  <div class="kss-description">
            <p>The layout styling for major parts of the page that are included with the
theme. Note: some Panels layouts are included in other parts of the system
and are not documented.</p>

          </div>
        
              </div>

      
              <div class="kss-source kss-style">
          Source: <code>styles.scss</code>, line 30
        </div>
          </div>
          <section id="kssref-layouts-layout-center" class="kss-section kss-section--depth-2">
      <div class="kss-style">
                <h2 class="kss-title kss-title--level-2">
          <a class="kss-title__permalink" href="#kssref-layouts-layout-center">
            <span class="kss-title__ref">
              3.1
              <span class="kss-title__permalink-hash">
                layouts.layout-center
              </span>
            </span>
            Layout Center
          </a>
        </h2>

                  <div class="kss-description">
            <p>All other layouts should be nested inside this centered layout to ensure that
content does not get too wide on very large screens.</p>
<p>Applying a <code>.layout-*</code> class to the same HTML element as <code>.layout-center</code>
would cause that element&#39;s grid to mis-align with the rest of the grid on the
page, but this component will automatically detect the other <code>.layout-*</code>
class and automatically use the <code>.layout-center--shared-grid</code> variant
instead.</p>

          </div>
        
              </div>

              <div class="kss-modifier__wrapper">
          <div class="kss-modifier__heading kss-style">
            Examples          </div>

                      <div class="kss-modifier__default-name kss-style">
              Default styling
            </div>
          
          <div class="kss-modifier__example">
            <div class="layout-center [modifier class]">
  This is layout center that has content is centered on larger screens.
</div>

          </div>

                      <div class="kss-modifier__name kss-style">
              .layout-center--shared-grid
            </div>
            <div class="kss-modifier__description kss-style">
              If <code>.layout-center</code> is applied to the same div as another .layout-<em> class, then this variant should be used to prevent the shared layout&#39;s grid from mis-aligning. Note: Each time a new .layout-</em> component is created, this component will need to be modified.
            </div>
            <div class="kss-modifier__example">
              <div class="layout-center layout-center--shared-grid">
  This is layout center that has content is centered on larger screens.
</div>

            </div>
                  </div>
                  <div class="kss-markup kss-style">
            <pre class="prettyprint linenums lang-html"><code data-language="html">&lt;div class=&quot;layout-center [modifier class]&quot;&gt;
  This is layout center that has content is centered on larger screens.
&lt;/div&gt;
</code></pre>
          </div>
              
              <div class="kss-source kss-style">
          Source: <code>layouts/layout-center/_layout-center.scss</code>, line 5
        </div>
          </section>
          <section id="kssref-layouts-layout-3col" class="kss-section kss-section--depth-2">
      <div class="kss-style">
                <h2 class="kss-title kss-title--level-2">
          <a class="kss-title__permalink" href="#kssref-layouts-layout-3col">
            <span class="kss-title__ref">
              3.2
              <span class="kss-title__permalink-hash">
                layouts.layout-3col
              </span>
            </span>
            Responsive 3-column grid
          </a>
        </h2>

                  <div class="kss-description">
            <p>The <code>.layout-3col</code> layout is a responsive grid layout that is:</p>
<ul>
<li>1 column at mobile sizes</li>
<li>2 columns at tablet sizes</li>
<li>3 columns at desktop sizes</li>
</ul>
<p>The <code>.layout-3col</code> class is used on the container div for the layout. A <em>grid
item</em> in the container can be created using one of the following classes:</p>
<ul>
<li><code>.layout-3col__full</code> : 3-column wide grid item; starts a new row</li>
<li><code>.layout-3col__left-content</code> : 2-column wide grid item, spanning columns 1
and 2; starts a new row</li>
<li><code>.layout-3col__right-content</code> : 2-column wide grid item, spanning columns 2
and 3; starts a new row</li>
<li><code>.layout-3col__left-sidebar</code> : 1-column wide grid item spanning column 1;
starts a new row on tablet screens</li>
<li><code>.layout-3col__first-left-sidebar</code> : 1-column wide grid item spanning column 1;
spans column 1 and starts a new row on tablet screens only</li>
<li><code>.layout-3col__second-left-sidebar</code> : 1-column wide grid item spanning column 1;
spans column 2 on tablet screens only</li>
<li><code>.layout-3col__right-sidebar</code> : 1-column wide grid item spanning column 3;
starts a new row on tablet screens</li>
<li><code>.layout-3col__col-1</code> : 1-column wide grid item spanning column 1; starts a
new row</li>
<li><code>.layout-3col__col-2</code> : 1-column wide grid item spanning column 2</li>
<li><code>.layout-3col__col-3</code> : 1-column wide grid item spanning column 3; starts a
new row on tablet screens</li>
<li><code>.layout-3col__col-4</code> : At tablet sizes, the <code>__col-x</code> grid items will form
an irregular layout of 2 items in the first row and 1 item in the second
row. The <code>__col-4</code> is a &quot;hidden&quot; item that does not appear on the
large-screen 3-column grid, but is a 1-column wide grid item spanning
column 2 on tablet screens.</li>
<li><code>.layout-3col__col-x</code> : 1-column wide grid item spanning column 1; when
several of these are used inside a <code>.layout-3col__grid-item-container</code> or
<code>.layout-3col</code>, the first one is positioned like <code>__col-1</code>, the
second like <code>__col-2</code>, etc.</li>
</ul>
<p>There are 2 ways to do a nested grid:</p>
<ol>
<li>Place a grid container div inside a grid item. Just apply the normal
classes to the nested grid container and its grid items.</li>
<li>The grid item&#39;s div is also the grid container for the nested grid. In
this case, the <code>.layout3-col__grid-item-container</code> class should be added
to the div to ensure its nested grid items align with the parent grid.</li>
</ol>

          </div>
        
              </div>

              <div class="kss-modifier__wrapper">
          <div class="kss-modifier__heading kss-style">
            Example          </div>

          
          <div class="kss-modifier__example">
            <div class="layout-3col ">
  <div class="layout-3col__full">
    The <code>.layout-3col__full</code> grid item.
  </div>
  <div class="layout-3col__left-content">
    The <code>.layout-3col__left-content</code> grid item.
  </div>
  <div class="layout-3col__right-sidebar">
    The <code>.layout-3col__right-sidebar</code> grid item.
  </div>
  <div class="layout-3col__right-content">
    The <code>.layout-3col__right-content</code> grid item.
  </div>
  <div class="layout-3col__left-sidebar">
    The <code>.layout-3col__left-sidebar</code> grid item.
  </div>
  <div class="layout-3col__right-content">
    The <code>.layout-3col__right-content</code> grid item.
  </div>
  <div class="layout-3col__first-left-sidebar">
    The <code>.layout-3col__first-left-sidebar</code> grid item.
  </div>
  <div class="layout-3col__second-left-sidebar">
    The <code>.layout-3col__second-left-sidebar</code> grid item.
  </div>
  <div class="layout-3col__col-1">
    The <code>.layout-3col__col-1</code> grid item.
  </div>
  <div class="layout-3col__col-2">
    The <code>.layout-3col__col-2</code> grid item.
  </div>
  <div class="layout-3col__col-3">
    The <code>.layout-3col__col-3</code> grid item. Don't forget to look for the <code>.layout-3col__col-4</code> grid item at tablet sizes.
  </div>
  <div class="layout-3col__col-4">
    The <code>.layout-3col__col-4</code> grid item.
  </div>
  <div class="layout-3col__full layout-3col__grid-item-container">
    <div class="layout-3col__col-x">
      The first <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
    <div class="layout-3col__col-x">
      The second <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
    <div class="layout-3col__col-x">
      The third <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
    <div class="layout-3col__col-x">
      The fourth <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
    <div class="layout-3col__col-x">
      The fifth <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
    <div class="layout-3col__col-x">
      The sixth <code>.layout-3col__col-x</code> grid item in this nested grid.
    </div>
  </div>
</div>

          </div>

                  </div>
                  <div class="kss-markup kss-style">
            <pre class="prettyprint linenums lang-html"><code data-language="html">&lt;div class=&quot;layout-3col &quot;&gt;
  &lt;div class=&quot;layout-3col__full&quot;&gt;
    The &lt;code&gt;.layout-3col__full&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__left-content&quot;&gt;
    The &lt;code&gt;.layout-3col__left-content&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__right-sidebar&quot;&gt;
    The &lt;code&gt;.layout-3col__right-sidebar&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__right-content&quot;&gt;
    The &lt;code&gt;.layout-3col__right-content&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__left-sidebar&quot;&gt;
    The &lt;code&gt;.layout-3col__left-sidebar&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__right-content&quot;&gt;
    The &lt;code&gt;.layout-3col__right-content&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__first-left-sidebar&quot;&gt;
    The &lt;code&gt;.layout-3col__first-left-sidebar&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__second-left-sidebar&quot;&gt;
    The &lt;code&gt;.layout-3col__second-left-sidebar&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__col-1&quot;&gt;
    The &lt;code&gt;.layout-3col__col-1&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__col-2&quot;&gt;
    The &lt;code&gt;.layout-3col__col-2&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__col-3&quot;&gt;
    The &lt;code&gt;.layout-3col__col-3&lt;/code&gt; grid item. Don&#039;t forget to look for the &lt;code&gt;.layout-3col__col-4&lt;/code&gt; grid item at tablet sizes.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__col-4&quot;&gt;
    The &lt;code&gt;.layout-3col__col-4&lt;/code&gt; grid item.
  &lt;/div&gt;
  &lt;div class=&quot;layout-3col__full layout-3col__grid-item-container&quot;&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The first &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The second &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The third &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The fourth &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The fifth &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
    &lt;div class=&quot;layout-3col__col-x&quot;&gt;
      The sixth &lt;code&gt;.layout-3col__col-x&lt;/code&gt; grid item in this nested grid.
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</code></pre>
          </div>
              
              <div class="kss-source kss-style">
          Source: <code>layouts/layout-3col/_layout-3col.scss</code>, line 1
        </div>
          </section>
          <section id="kssref-layouts-layout-swap" class="kss-section kss-section--depth-2">
      <div class="kss-style">
                <h2 class="kss-title kss-title--level-2">
          <a class="kss-title__permalink" href="#kssref-layouts-layout-swap">
            <span class="kss-title__ref">
              3.3
              <span class="kss-title__permalink-hash">
                layouts.layout-swap
              </span>
            </span>
            Layout swap
          </a>
        </h2>

                  <div class="kss-description">
            <p>Uses absolute positioning and selective padding to make 2 elements appear to
swap places in the visual order while maintaining their original HTML source
order.</p>

          </div>
        
              </div>

              <div class="kss-modifier__wrapper">
          <div class="kss-modifier__heading kss-style">
            Example          </div>

          
          <div class="kss-modifier__example">
            <div class="layout-swap">
  <div>This element comes <strong>first</strong> in the HTML source order.</div>
  <div class="layout-swap__top">This element comes <strong>second</strong> in the HTML source order.</div>
</div>

          </div>

                  </div>
                  <div class="kss-markup kss-style">
            <pre class="prettyprint linenums lang-html"><code data-language="html">&lt;div class=&quot;layout-swap&quot;&gt;
  &lt;div&gt;This element comes &lt;strong&gt;first&lt;/strong&gt; in the HTML source order.&lt;/div&gt;
  &lt;div class=&quot;layout-swap__top&quot;&gt;This element comes &lt;strong&gt;second&lt;/strong&gt; in the HTML source order.&lt;/div&gt;
&lt;/div&gt;
</code></pre>
          </div>
              
              <div class="kss-source kss-style">
          Source: <code>layouts/layout-swap/_layout-swap.scss</code>, line 4
        </div>
          </section>
  </article>

<!-- SCRIPTS -->
<script src="kss-assets/kss.js"></script>
<script src="kss-assets/scrollspy.js"></script>
<script src="kss-assets/prettify.js"></script>
<script>
  prettyPrint();
  var spy = new ScrollSpy('#kss-node', {
    nav: '.kss-nav__menu-child > li > a',
    className: 'is-in-viewport'
  });
</script>




<!-- Automatically built using <a href="https://github.com/kss-node/kss-node">kss-node</a>. -->
</body>
</html>
